DTMF and Hook-Flash Parameters
The DTMF and hook-flash parameters are described in the table below.
DTMF and Hook-Flash Parameters
Parameter |
Description |
||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Hook-Flash Parameters | |||||||||||||||||||||||||||||||||||||||||||
'Hook-Flash Code' configure voip > gateway dtmf-supp-service supp-service-settings > hook-flash-code [HookFlashCode] |
Defines the digit pattern used by the PBX to indicate a Hook Flash event. When this pattern is detected from the Tel side, the device responds as if a Hook Flash event has occurred and sends a SIP INFO message if the HookFlashOption parameter is set to 1, 5, 6, or 7 (indicating a Hook Flash). If configured and a Hook Flash indication is received from the IP side, the device generates this pattern to the Tel side. The valid range is a 25-character string. The default is a null string. Note: The parameter can also be configured in a Tel Profile. |
||||||||||||||||||||||||||||||||||||||||||
'Hook-Flash Option' configure voip > gateway dtmf-supp-service dtmf-and-dialing > hook-flash-option [HookFlashOption] |
Defines the hook-flash transport type (i.e., method by which hook-flash is sent and received). The feature is applicable only if the HookFlashCode parameter is configured.
The device sends the INFO message as follows: Content-Type: application/broadsoft; version=1.0 Content-Length: 17 event flashhook
The device sends the INFO message as follows: Content-Type: application/hook-flash Content-Length: 11 signal=hf
Content-Type: application/dtmf-relay Signal=16 Where 16 is the DTMF code for hook flash.
Content-Length: 17 Content-Type: application/sscc event=flashhook Note:
|
||||||||||||||||||||||||||||||||||||||||||
DTMF Parameters |
|
||||||||||||||||||||||||||||||||||||||||||
notify-on-sig-end [MGCPDTMFDetectionPoint] |
Determines when the detection of DTMF events is notified.
|
||||||||||||||||||||||||||||||||||||||||||
'Declare RFC 2833 in SDP' configure voip > gateway dtmf-supp-service dtmf-and-dialing > rfc-2833-in-sdp [RxDTMFOption] |
Global parameter that enables the device to declare the RFC 2833 'telephony-event' parameter in the SDP. You can also configure this feature per specific calls, using IP Profiles ('Rx DTMF Option' parameter). For a detailed description of the parameter and for configuring this feature in the IP Profiles table, see Configuring IP Profiles. Note: If you configure this feature for a specific IP Profile, the device ignores this global parameter for calls associated with the IP Profile. |
||||||||||||||||||||||||||||||||||||||||||
'First Tx DTMF Option' configure voip > gateway dtmf-supp-service dtmf-and-dialing > first-dtmf-option-type [FirstTxDTMFOption] |
Defines the first preferred transmit (Tx) DTMF negotiation method.
Note:
|
||||||||||||||||||||||||||||||||||||||||||
'Second Tx DTMF Option' configure voip > gateway dtmf-supp-service dtmf-and-dialing > second-dtmf-option-type [SecondTxDTMFOption] |
Defines the second preferred transmit (Tx) DTMF negotiation method. The first preferred method is configured by the FirstTxDTMFOption parameter. For a description of the optional values for the parameter, see the FirstTxDTMFOption parameter above. Note: You can also configure the parameter per specific calls, using IP Profiles ('Second Tx DTMF Option' parameter). To configure IP Profiles, see Configuring IP Profiles. |
||||||||||||||||||||||||||||||||||||||||||
[AdditionalOutOfBandDtmfFormat] |
Enables the device to simultaneously send DTMF tones (signals) in SIP messages such as INFO messages (out-of-band) and in RTP media streams (in-band) with a special payload type (as defined in RFC 2833), when the FirstTxDTMFOption parameter is configured to 4. The parameter must be configured to the method for transporting DTMF digits over the IP network to the remote endpoint. For more information on DTMF transport, see Configuring DTMF Transport Types.
|
||||||||||||||||||||||||||||||||||||||||||
configure voip > gateway dtmf-supp-service dtmf-and-dialing > auto-dtmf-mute [DisableAutoDTMFMute] |
Enables the automatic muting of DTMF digits when out-of-band DTMF transmission is used.
When the parameter is set to [1], the DTMF transport type is set according to the parameter [DTMFTransportType] and the DTMF digits aren't muted if out-of-band DTMF mode is selected -- [FirstTxDTMFOption] set to [1], [2] or [3]. This enables the sending of DTMF digits in-band (transparent of RFC 2833) in addition to out-of-band DTMF messages. |
||||||||||||||||||||||||||||||||||||||||||
'Enable Digit Delivery to IP' configure voip > sip-definition settings > digit-delivery-2ip [EnableDigitDelivery2IP] |
Enables the Digit Delivery feature whereby DTMF digits are sent to the destination IP address after the Tel-to-IP call is answered.
To enable this feature, modify the called number to include at least one 'p' character. The device uses the digits before the 'p' character in the initial INVITE message. After the call is answered, the device waits for the required time (number of 'p' multiplied by 1.5 seconds), and then sends the rest of the DTMF digits using the method chosen (in-band or out-of-band). Note: The called number can include several 'p' characters (1.5 seconds pause), for example, 1001pp699, 8888p9p300. |
||||||||||||||||||||||||||||||||||||||||||
'Enable Digit Delivery to Tel' configure voip > sip-definition settings > digit-delivery-2tel [EnableDigitDelivery] |
Global parameter enabling the Digit Delivery feature, which sends DTMF digits of the called number to the Tel side (analog port or B-channel for digital interfaces) after the call is answered for IP-to-Tel calls. You can also configure the feature per specific calls, using Tel Profiles ('Enable Digit Delivery' parameter). For a detailed description of the parameter and To configure the feature in the Tel Profiles table, see Configuring Tel Profiles. Note: If the feature is configured for a specific Tel Profile, the settings of the global parameter is ignored for calls associated with the Tel Profile. |
||||||||||||||||||||||||||||||||||||||||||
'Special Digit Representation' configure voip > gateway dtmf-supp-service dtmf-and-dialing > special-digit-rep [UseDigitForSpecialDTMF] |
Defines the representation for ‘special’ digits (‘*’ and ‘#’) that are used for out-of-band DTMF signaling (using SIP INFO/NOTIFY).
|
||||||||||||||||||||||||||||||||||||||||||
isdn-keypad-mode [ISDNKeypadMode] |
Enables the device to send DTMF digits received in the called party number from the IP side, as Keypad facility IE in ISDN INFORMATION messages to PSTN.
For more information, see Interworking Keypad DTMFs for SIP-to-ISDN Calls. Note:
|